Release 10.1A: OpenEdge Development:
ADM Reference
dataAvailable
Event procedure that generates a dependent query dynamically based on the ForeignFields property. This event occurs when dataAvailable is published by a data source because the data source has been repositioned to a different row in its query and this has an impact on dependent objects.
Location: query.p Parameters:INPUT pcRelative AS CHARACTERProvides information about a newly available record. Valid entries are:
- SAME — The current record is being resent because it has been updated. This procedure ignores this value.
- VALUE–CHANGED — A target SmartDataObject has changed its query position. This procedure needs to set the QueryPosition property then change pcRelative to DIFFERENT before passing it to other target procedures so that it appears as though the change occurred in this procedure.
- RESET — Resets the status and foreign fields, and refreshes visual objects and panels for all objects that are part of the data link. This option provides more functionality than SAME and less functionality that DIFFERENT. Use this option when you want to send notification about a change in the RowObject record without having to reopen all the dependent queries.
- DIFFERENT — Values for Foreign Fields should be reapplied.
- FIRST, NEXT, PREV, LAST— Treated the same as DIFFERENT in this version of dataAvailable.
Notes: This version of data Available is for SmartDataObjects that depend on another SmartDataObject. The code is different from that for a Viewer. If there are no Foreign Fields, then this procedure is run when a target is repositioned (usually a SmartDataBrowser). In this case, just the event is passed on to other targets.- TRANSFER — Joins the child data object to the current record in a parent data object. As a result, the call only needs to be performed in the parent data object inside of a container.
|
Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |